Crate tracing_distributed

This crate provides:

• TelemetryLayer, a generic tracing layer that handles publishing spans and events to arbitrary backends
• Utilities for implementing distributed tracing for arbitrary backends

As a tracing layer, TelemetryLayer can be composed with other layers to provide stdout logging, filtering, etc.

This crate is primarily intended to be used by people implementing their own backends. A concrete implementation using honeycomb.io as a backend is available in the tracing-honeycomb crate.

Structs

• BlackholeTelemetry
  Telemetry implementation that does not publish information to any backend. For use in tests.
• Event
  An Event holds ready-to-publish information derived from a tracing::Event.
• Span
  A Span holds ready-to-publish information gathered during the lifetime of a tracing::Span.
• TelemetryLayer
  A tracing_subscriber::Layer that publishes events and spans to some backend using the provided Telemetry capability.

Enums

• TraceCtxError
  Errors that can occur while registering the current span as a distributed trace root or attempting to retrieve the current trace context.

Traits

• Telemetry
  Represents the ability to publish events and spans to some arbitrary backend.

Functions

• current_dist_trace_ctx
  Retrieve the distributed trace context associated with the current span. Returns the TraceId, if any, that the current span is associated with along with the SpanId belonging to the current span.
• register_dist_tracing_root
  Register the current span as the local root of a distributed trace.